home *** CD-ROM | disk | FTP | other *** search
/ SGI Hot Mix 17 / Hot Mix 17.iso / HM17_SGI / research / lib / man_proc.pro < prev    next >
Text File  |  1997-07-08  |  2KB  |  97 lines
  1. ; $Id: man_proc.pro,v 1.3 1997/01/15 03:11:50 ali Exp $
  2. ;
  3. ; Copyright (c) 1991-1997, Research Systems, Inc.  All rights reserved.
  4. ;       Unauthorized reproduction prohibited.
  5.  
  6. ;+
  7. ; NAME:
  8. ;    MAN_PROC
  9. ;
  10. ; PURPOSE:
  11. ;    Provide online documentation for IDL topics.  If the current
  12. ;    graphics device supports widgets, a graphical user interface
  13. ;    is used.  Otherwise, a more basic version that is a cross
  14. ;    between the Unix man pages and VMS online help is used.  The
  15. ;    help is organized in a two-level hierarchy.  Level 1 is the
  16. ;    global subject, and Level 2 supplies help on subjects within
  17. ;    each global subject.
  18. ;
  19. ; CATEGORY:
  20. ;    Help, documentation.
  21. ;
  22. ; CALLING SEQUENCE:
  23. ;    MAN_PROC [, Request]
  24. ;
  25. ; INPUTS:
  26. ;     Request:    A scalar string containing the item for which help is desired.
  27. ;        This string can contain one or two (whitespace separated) 
  28. ;        words.  The first word is taken as the global topic and the 
  29. ;        second as the topic within the scope of the first.  The user
  30. ;        is prompted for missing words.
  31. ;
  32. ; OUTPUTS:
  33. ;    The widget version uses a text widget to display the help
  34. ;    text.  The basic version sends help text to the standard output.
  35. ;
  36. ; COMMON BLOCKS:
  37. ;    None.
  38. ;
  39. ; RESTRICTIONS:
  40. ;    The help text is derived from the LaTeX files used to produce
  41. ;    the reference manual.  However, it is not possible to produce
  42. ;    exactly the same output as found in the manual due to the limitations
  43. ;    of text-oriented terminals.  Therefore, the text used is considerably
  44. ;    abbreviated.  Always check the manual if the online help is
  45. ;    insufficient. 
  46. ;
  47. ; MODIFICATION HISTORY:
  48. ;    4 January 1991, AB    Renamed the old MAN_PROC to MP_BASIC and added
  49. ;                 MP_WIDGETS to handle the widget interface.
  50. ;    3 September 1992, AB    Switched from the IDLwidgets version
  51. ;                (MP_WIDGETS) to the builtin help. This allows
  52. ;                help and the IDL> prompt to work simultaneously
  53. ;    17 May 1993, AB        Reverted to using MP_WIDGETS for the Sun 3
  54. ;                because it is stuck at OpenWindows 2.0 and
  55. ;                recent changes to online help will not be
  56. ;                ported to that platform.
  57. ;-
  58. ;
  59.  
  60. PRO MAN_PROC, REQUEST
  61.  
  62.   ; If the current graphics device supports widgets, use them. Otherwise,
  63.   ; use the basic version. Sun 3s use the old MP_WIDGETS
  64.   if ((!D.FLAGS and 65536) eq 0) then begin
  65.     MP_BASIC, REQUEST
  66.   endif else begin
  67.     if ((!version.os eq 'sunos') and (!version.arch eq 'mc68020')) then begin
  68.       MP_WIDGETS, REQUEST
  69.     endif else begin
  70.       WIDGET_OLH, REQUEST
  71.     endelse
  72.   endelse
  73.  
  74. end
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.